Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Time Base Functions / Working With Time Base Values

GetTimeBaseTime

Your application can use the GetTimeBaseTime function to obtain the current time value from a time base. You can specify the time scale in which to return the time value.

pascal TimeValue GetTimeBaseTime (TimeBase tb, TimeScale s,
                                  TimeRecord *tr);

tb

Specifies the time base for this operation. Your application obtains this time base identifier from the NewTimeBase function (described on page 2-297).

s

Specifies the time scale in which to return the current time value. Set this parameter to 0 to retrieve the time in the preferred time scale of the time base.

tr

Contains a pointer to a time structure that is to receive the current time value. This is an optional parameter. If you do not want the time value represented in a time structure, set this parameter to nil.

DESCRIPTION

The GetTimeBaseTime function returns a time value that contains the current time from the specified time base in the specified time scale. The function returns this value even if you specify a time structure with the tr parameter.

ERROR CODES

None

SEE ALSO

You can set the current time of a time base by calling either the SetTimeBaseTime or SetTimeBaseValue functions, which are described on page 2-304 and page 2-305, respectively.